Skip to main content
GET
/
tariffs
/
{id}
/
[beta] Get detailed tariff information
curl --request GET \
  --url https://sandbox.prezio.eu/api/tariffs/{id}/ \
  --header 'Authorization: <api-key>'
{
  "id": "tar_45",
  "name": "Advanced Business Tariff",
  "has_time_of_use": true,
  "has_tiers": true,
  "has_calculation_input": true,
  "has_properties": true,
  "local_consumer_types": [
    {
      "id": "lct_123",
      "key": "b_low",
      "name": "Business Low Voltage",
      "consumer_type": "BUSINESS"
    }
  ],
  "context": {
    "country": {
      "code": "DK",
      "timezone_default": "Europe/Copenhagen",
      "currency": "DKK"
    },
    "organization": {
      "id": "org_285",
      "name": "Copenhagen DSO",
      "type": "DSO"
    },
    "main_tariff": {
      "id": "mta_33",
      "name": "Advanced Pricing",
      "description": "Time-variable pricing with demand components"
    }
  },
  "tariff_properties": [
    {
      "id": "pro_15",
      "key": "contract_type",
      "name": "Contract Type",
      "data_type": "CHOICE",
      "group_key": "tariff_type",
      "group_name": "Tariff Type",
      "question": "What type of electricity contract do you prefer?",
      "description": "Different pricing structures available",
      "choices": [
        {
          "id": "prv_13",
          "name": "Spot",
          "value": "spot"
        }
      ]
    },
    {
      "id": "pro_16",
      "key": "price_duration",
      "name": "Price Variability Duration",
      "data_type": "CHOICE",
      "group_key": "tariff_type",
      "group_name": "Tariff Type",
      "question": "How often do you want price updates?",
      "description": "Frequency of price changes",
      "choices": [
        {
          "id": "prv_41",
          "name": "Hourly",
          "value": "1h"
        }
      ]
    }
  ],
  "tou_levels": [
    {
      "id": "tou_146",
      "name": "Peak",
      "type": "ON_PEAK",
      "periods": [
        {
          "from_time": "17:00",
          "to_time": "20:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 17:00-20:59"
        }
      ]
    },
    {
      "id": "tou_162",
      "name": "Partial peak",
      "type": "PARTIAL_PEAK",
      "periods": [
        {
          "from_time": "05:00",
          "to_time": "16:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 05:00-16:59"
        },
        {
          "from_time": "21:00",
          "to_time": "23:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 21:00-23:59"
        }
      ]
    },
    {
      "id": "tou_145",
      "name": "Off-peak",
      "type": "OFF_PEAK",
      "periods": [
        {
          "from_time": "00:00",
          "to_time": "04:59",
          "from_day": 1,
          "to_day": 0,
          "summary": "Mon-Sun: 00:00-04:59"
        }
      ]
    }
  ],
  "components": [
    {
      "id": "com_1889",
      "name": "TOU Demand",
      "key": "tou_demand",
      "description": "Time-of-use demand charge",
      "type": "DEMAND",
      "unit": "kw_per_month",
      "direction": "IMP",
      "has_time_of_use": true,
      "has_tiers": false,
      "has_calculation_input": true,
      "has_properties": false,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": "2025-12-31T23:59:59+01:00",
      "calculation_requirements": [
        {
          "type": "CALCULATION_INPUT",
          "key": "peak_demand",
          "name": "Peak Demand",
          "input_unit": "KW",
          "input_period": "MONTH",
          "choices": [
            {
              "key": "peak_demand_single",
              "type": "SINGLE_VALUE"
            }
          ]
        },
        {
          "type": "TOU_LEVEL",
          "key": "tou",
          "name": "Time of Use Level",
          "choices": [
            {
              "id": "tou_146",
              "type": "ON_PEAK"
            },
            {
              "id": "tou_162",
              "type": "PARTIAL_PEAK"
            },
            {
              "id": "tou_145",
              "type": "OFF_PEAK"
            }
          ]
        }
      ]
    },
    {
      "id": "com_15555",
      "name": "Energy Consumption (kWh)",
      "key": "kwh",
      "description": "Variable energy consumption charge",
      "type": "KWH",
      "unit": "kwh",
      "direction": "IMP",
      "has_time_of_use": true,
      "has_tiers": false,
      "has_calculation_input": true,
      "has_properties": true,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": null,
      "calculation_requirements": [
        {
          "type": "CALCULATION_INPUT",
          "key": "consumption",
          "name": "Energy Consumption (kWh)",
          "input_unit": "KWH",
          "input_period": null,
          "choices": [
            {
              "key": "consumption_profile",
              "type": "TIME_SERIES"
            },
            {
              "key": "consumption_total",
              "type": "SINGLE_VALUE"
            }
          ]
        },
        {
          "type": "TOU_LEVEL",
          "key": "tou",
          "name": "Time of Use Level",
          "choices": [
            {
              "id": "tou_146",
              "type": "ON_PEAK"
            },
            {
              "id": "tou_162",
              "type": "PARTIAL_PEAK"
            },
            {
              "id": "tou_145",
              "type": "OFF_PEAK"
            }
          ]
        }
      ]
    },
    {
      "id": "com_15552",
      "name": "Capacity Fuses",
      "key": "capacity_fuses",
      "description": "Fixed charge based on fuse level",
      "type": "FIXED",
      "unit": "per_month",
      "direction": "IMP",
      "has_time_of_use": false,
      "has_tiers": false,
      "has_calculation_input": false,
      "has_properties": true,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": null,
      "calculation_requirements": [
        {
          "type": "PRICE_PROPERTY",
          "key": "fuse_level",
          "name": "Fuse Level",
          "data_type": "CHOICE",
          "choices": [
            "16",
            "20",
            "25"
          ]
        }
      ]
    },
    {
      "id": "com_15551",
      "name": "Energy Tax",
      "key": "energy_tax",
      "description": "Government energy tax",
      "type": "TAX",
      "unit": "percent",
      "direction": "IMP",
      "has_time_of_use": false,
      "has_tiers": false,
      "has_calculation_input": false,
      "has_properties": false,
      "applicable_vat_rate": "standard",
      "from": "2025-07-01T00:00:00+02:00",
      "to": null
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Path Parameters

​
id
string
required

Tariff ID with "tar_" prefix or raw integer (e.g., "tar_789", "789")

Query Parameters

​
include_tariff_properties
boolean

Include tariff_properties (similar to the data from the list endpoint) section in response (default: false)

​
include_tou_details
boolean

Include detailed information about tou_levels including periods (default: false)

​
valid_at
string

Filter components to show only those with active prices at the specified datetime. Also determines the validity range shown in component 'from' and 'to' fields, and affects the calculation of tariff-level flags. Format: 'YYYY-MM-DDTHH:MM:SS' (ISO 8601). If not provided, uses current time.

Response

Success - Returns detailed tariff information incl. advanced calculation requirements

Enhanced serializer for detailed tariff retrieval using common mixins

​
context
object
required

Contextual information about the tariff, including country, organization, and main tariff details

Example:
{
  "country": {
    "code": "DK",
    "timezone_default": "Europe/Copenhagen",
    "currency": "DKK"
  },
  "organization": {
    "id": "org_285",
    "name": "Copenhagen DSO",
    "type": "DSO"
  },
  "main_tariff": {
    "id": "mta_33",
    "name": "Advanced Pricing",
    "description": "Time-variable pricing with demand components"
  }
}
​
id
integer
required
​
name
string
required
Maximum length: 255
​
has_time_of_use
boolean
required

Flag indicating if the tariff has time-of-use pricing (different rates for different times of day)

Example:

true

​
has_tiers
string
required

Flag indicating if the tariff has tiered pricing (different rates based on consumption levels)

​
has_calculation_input
string
required

Flag indicating if the tariff requires calculation inputs for pricing (e.g., demand values, consumption profiles)

​
has_properties
string
required

Flag indicating if the tariff has price-level properties or multiple price variants

​
local_consumer_types
object[]
required

Consumer type classifications applicable to this tariff (e.g., residential, business, low voltage)

Example:
[
  {
    "id": "lct_123",
    "key": "b_low",
    "name": "Business Low Voltage",
    "consumer_type": "BUSINESS"
  }
]
​
tariff_properties
object[]
required

Detailed tariff properties and configuration options that affect pricing

​
tou_levels
string
required

Time-of-use level definitions with detailed period information for complex pricing structures